home *** CD-ROM | disk | FTP | other *** search
/ Aminet 23 / Aminet 23 (1998)(GTI - Schatztruhe)[!][Feb 1998].iso / Aminet / disk / misc / xfs208b.lha / xfs208_beta / xfs208b.readme < prev    next >
Text File  |  1997-12-14  |  12KB  |  315 lines
  1. Short: Multi filesys+.device, pc+pcw+minix+more
  2. Uploader:
  3. Author: frans (francis swift)
  4. Type: disk/misc
  5. Replaces: xfs207b2
  6.  
  7. --------------------------- xfs208b ----------------------------
  8.  
  9. MINIX FileSystem now working (read-only).
  10.  
  11. New system for enabling/disabling the mounting of volumes, and
  12. for disabling recognition of certain disks (no more xfsd-ami)
  13.  
  14. ...see mount.xfsd for details
  15.  
  16. CPM3 Filesystem (well PCW 3.5 inch 720K disks) (read-only)
  17.  
  18. I have precisely one PCW disk and it works perfectly, so there.
  19.  
  20. Sorry, the mac handler just recognises that the disk is indeed a
  21. Mac disk, reads the volume name, then just sits there and refuses
  22. to do anything else. Maybe next time.
  23.  
  24. --------------------------- xfs207b2 ----------------------------
  25. ALL NEW INTRO!!!
  26.  
  27. Well, just a few extra words.
  28.  
  29. Ther was a hash clash (try saying that quickly) in the internal
  30. name cache (or should that be hash cache?) between the short names
  31. and the long names. Basically, the dummy short name entries were
  32. displacing the true long name entries, thus losing all the internal
  33. pointers etc, so the directory listings (which don't use the name
  34. cache) showed all the files, but the handler couldn't access them.
  35.  
  36. I'm still working on the MAC handler, based on code from the
  37. hfsutils package on linux, written by Robert Leslie.
  38. Hopefully, because I'm basing it on working code, it should work
  39. as a complete read/write handler as soon as it's finished :-)
  40.  
  41. EXTRA BONUS  *** x-hfsdir ***  EXTRA BONUS
  42.  
  43. Mount DEV: (you've already got it - see the mount list for details)
  44. then you can get a directory of a MAC disk with
  45.  
  46. x-hfsdir dev:mfm.device,1
  47.  
  48. or, if there's a subdirectory called hyper
  49.  
  50. x-hfsdir dev:mfm.device,1 hyper
  51.  
  52. and a subdirectory in there called new
  53.  
  54. x-hfsdir dev:mfm.device,1 hyper/new
  55.  
  56. you get the picture, just remember the ,1 means drive unit 1 (df1:)
  57.  
  58. --------------------------- xfs207b -----------------------------
  59.  
  60. FD.DEVICE and XFSD HANDLER
  61.  
  62. This is a powerful Amiga device and handler combination which allows
  63. any drive to read more than a dozen formats, all accessed via a single
  64. desktop icon and drive name - regardless of the system that originally
  65. wrote the disk.
  66.  
  67. This is the product of years of development by the author of
  68. QL_Handler (for Qdos disks) and SP_Handler (for Spectrum disks)
  69. which are included in the Qdos4Amiga and Speculator97 distributions.
  70. Like all Frank Swift's Amiga programs, it is freely distributable.
  71.  
  72. It is a response to the way icons could proliferate on the desktop
  73. with lots of handlers connected to each drive, in case a particular
  74. format disk was inserted. The recognition of disks became slow and
  75. handlers clashed in their interpretation of the disk format. There
  76. had to be a better way. This is it. It's much faster than multiple
  77. handlers, and more reliable too. It reads more formats than before,
  78. including some - like Windows95 long file names and Archimedes E
  79. format disks - which have not previously been supported by Amigas.
  80.  
  81. This program is free and supplied without warranty. If it doesn't
  82. work for you, remember how much you paid for it.
  83.  
  84. As often seems to happen, Simon Goodwin has ended up writing the
  85. documentation. This is a bit of a rush job, so if you'd like
  86. more documentation, send (constructive) comments to:
  87.  
  88.     simon@studio.woden.com
  89.  
  90. All technical comments and suggestions should go to the author,
  91. Frank Swift, who lives in the pre-modem world, where he can still
  92. get some real work done ;-) His snail-mail address is:
  93.  
  94.     325 Charlestown Road, Blackley, Manchester M9 7ES, UK.
  95.  
  96. Friendly feedback from users would be much appreciated.
  97.  
  98.  
  99.  
  100. Features
  101.  
  102. * A single Handler and device that reads the following formats:
  103.  
  104. Name           System                Make/Model
  105.  
  106. Acorn          Archimedes E format   Acorn Computers
  107. Amiga OFS      Workbench 1.x         Commodore
  108. Amiga FFS      Workbench 2.xx        Commodore
  109. Amiga FFS/DC   Workbench 3.xx        Commodore/Gateway
  110. Atari ST/TT    TOS 1, TOS 2 etc.     Atari Corporation
  111. BetaDOS        Spectrum and +D       BetaSoft
  112. Diskspare      Amiga custom          High capacity format
  113. GDOS           Sinclair Spectrum     MGT Disciple Interface
  114. G+DOS          Sinclair Spectrum     MGT/Datel +D interface
  115. MasterDOS      SAM Coupe             MGT and BetaSoft
  116. MSDOS          IBM PCs and clones    Microsoft licensees
  117. MSXDOS         All MSX disk micros   Sony, Toshiba etc.
  118. QDOS           QL & clones           Sinclair, CST, Miracle
  119. SAMDOS         SAM Coupe             Miles Gordon Technology
  120. Windows95/NT   Intel boxes & clones  Anyone with the $$$$$$$
  121.  
  122. Support for CP/M formats (particularly Amstrad PCW and Plus 3)
  123. and Apple Mac is hoped to follow if you make encouraging noises
  124. to the author. All other suggestions will be considered, as long
  125. as you can provide documentation of the low level and logical
  126. formats you'd like added. The intention is to make fd.device
  127. flexible enough to cope with any format the Amiga can access,
  128. including FM & GCR encodings and multiple sector-sizes per track.
  129. (CHIEF ENGINEER SCOTT: "mac handler in a couple of weeks, cap'n").
  130.  
  131. * Currently fd.device understands amiga style tracks (both normal
  132. and diskspare types) and pc style tracks (in most of the common
  133. sector sizes, eg 128, 256, 512, 1024, 2048 etc).
  134.  
  135. * Compatible with ALL Amiga systems from Workbench 1.2 to 3.1,
  136. so you can format OFS disks on an A4000, and read FFS DC ones
  137. on an old A500!
  138.  
  139. * Compatible with HD (High Density) drives as well as DD ones,
  140. and odd media sizes like 3 inch and 5.25 inch drives.
  141.  
  142. * Supports Windows95 long file names (and would write them too
  143. by now if Micro$oft hadn't found such an absurd way to add
  144. them to the MSDOS format!)
  145.  
  146. * Includes FILE0 and FILE1 icons that allow floppy disk images
  147. to be manipulated as files (containing a whole disk's contents)
  148. on other media, e.g. RAM or hard drive. If you can't see the
  149. point of this, you needn't worry about it. Just leave the icons
  150. where they are.
  151.  
  152.  
  153.  
  154. Limitations
  155.  
  156. Format disk works but always uses the format that the disk is already
  157. in - so you can't use XFileSystem to change the formatting of a disk.
  158. We have yet to work out a good way to indicate the desired format
  159. when there are so many possibilities, including various capacities
  160. for a given format: for instance single sided 360K ST, double sided
  161. 720K Mega ST and 1.44 Mb Atari TT formats...
  162.  
  163. This is the first release. Writing has only been extensively tested
  164. on Qdos format disks (DD and HD) and is not yet supported on Spectrum
  165. and PC formats. If you try it a seek error is the likely result. The
  166. disk contents will not be changed, but don't trust XFileSystem to
  167. your only copy of a file, just in case. You have been warned!
  168.  
  169. The wonderful CatWeasel disk controller is not supported because its
  170. MultiDisk device requires the user to decide the format of each disk,
  171. rather than letting the sytstem work it out for itself. The original
  172. QL_Handler and SP_Handler do work rather well with CatWeasel, though.
  173.  
  174.  
  175.  
  176. Installation (at last!)
  177.  
  178. The package is divided in standard Amiga style into two parts - a
  179. 'handler', XFSD which recognises the logical format of disks (the
  180. directory and file details) and a 'device', fd.device, which reads
  181. the disk tracks and decodes them into individual data 'sectors'.
  182.  
  183. There is a special version, XFSD-AMI, which includes support for
  184. the Amiga file structures. Normally this is not needed - you can
  185. use the DF0:, etc. icons as normal - but if you want the FD icon
  186. to recognise Amiga Diskspare, OFS or FFS disks you must copy the
  187. xfsd-ami version to directory L: renaming it to remove the -ami,
  188. in place of the standard xfsd which only reads 'alien' formats.
  189. However, if you use a normal amiga disk with this handler _both_
  190. the normal amiga handler _and_  xfsd would recognise it and try
  191. to mount the volume. Tricky. But see the mountlist for a sneaky
  192. workaround if you want to experiment.
  193.  
  194. The handler can be manually installed from Shell, Opus, Workbench
  195. etc. as follows;
  196.  
  197. Open the drawer "L" in the XFS directory and drag the program "xfsd"
  198. to your system "L:" drawer.
  199.  
  200. Open the drawer "DEVS" in the XFS directory and drag the program
  201. "fd.device" to your system "DEVS:" drawer.
  202.  
  203. Both files must be in the correct directory or the handler will not
  204. work. This is the most common reason people can't get new devices
  205. and handlers to work.
  206.  
  207. The procedure to give these programs access to your drives depends
  208. on your version of Workbench. Modern Amigas have a DEVS:DOSDRIVERS
  209. drawer which contains a 'setup' icon for each desktop drive icon.
  210. If you have an old system (such as Workbench 1.3) you'll need to
  211. edit your startup-sequence (user-startup on Workbench 2) file in
  212. the S: directory to 'mount' the devvice and handler on chosen drives.
  213.  
  214.  
  215. Procedure for Workbench 2.1 and later
  216.  
  217. Drag the icons FD0: and FD1: from "Devs/DOSDrivers" to your system
  218. "Storage/DOSDrivers" drawer or "Devices/DOSDrivers" drawer. The second
  219. choice will mount the X handler every time you reboot the system,
  220. allowing relatively instant access.
  221.  
  222. The handler is manually activated by double clicking the FD0: or FD1:
  223. icon in the Storage sub-directory. This makes the corresponding FD:
  224. icon appear on the desktop. Other programs can read the disk, whatever
  225. the format, by using the drive name prefix FD instead of DF. There are
  226. icons for two drives supplied; you can edit these by changing the name
  227. and UNIT number inside if you have more than two drives, e.g. UNIT=3
  228. for FD3: etc.
  229.  
  230. If you want the handlers to be activated automatically on start-up then
  231. they should be put in your system "Devs:DOSDrivers" drawer.
  232.  
  233.  
  234. Procedure for old Workbenches
  235.  
  236. Copy the mountlist.xfsd file to DEVS: and add a line to your startup
  237. for each drive you want to connect to XFS, as follows:
  238.  
  239. MOUNT FD0: FROM DEVS:mountlist.xfsd
  240.  
  241. MOUNT FD1: FROM DEVS:mountlist.xfsd
  242.  
  243. etcetera for up to four drives (FD0: FD1: FD2: and FD3: corresponding
  244. to DF0: to DF3: respectively).
  245.  
  246. If you just want to try it, without changing your startup, put the XFSD
  247. and fd.device files in the required directories (L: and DEVS:, remember)
  248. and type one of the above 'Mount' commands into a shell, or into the
  249. Workbench 2 'Execute Command' window (if you've got it).
  250.  
  251. ------------------------------------------------------------------------
  252. EXTRA EXTRA ............ fd.device / file.device ............ STOP PRESS
  253.  
  254. Disk recognition
  255.  
  256. As if all this was not enough, fd.device inserts an input stream handler
  257. to allow you to force it to re-read the disk, at the same time sending a
  258. disk change interrupt to whatever dos handler is using it.
  259.  
  260. The key combination(s) for fd.device are
  261.  
  262.     left_alt + numeric_pad(unit#)
  263.  
  264. ie left alt with numeric pad 0 would force a disk change on unit 0.
  265.  
  266. The same is true for the file.device, although in this case it also allows
  267. you to select another disk image file for access, via a requester.
  268.  
  269. The key combination(s) for file.device are
  270.  
  271.     left_alt + left_shift + numeric_pad(unit#)
  272.  
  273. ie left alt plus left shift plus numeric pad 1 would force a disk change
  274. on unit 1.
  275.  
  276. NOTEZ BIEN
  277.  
  278. This key usage may change - especially the particular key combinations
  279. (because they may clash with other programs).
  280.  
  281. ------------------------------------------------------------------------
  282.  
  283. POWER XL
  284.  
  285. The current fd.device doesn't work with the Power XL high density drive,
  286. but I'm pretty sure it's fixable. In the meantime I've included an
  287. earlier version (fd.device.old) that seems to work ok. If you need it,
  288. just rename it to fd.device and put it in devs:
  289. Unfortunately the geometry command doesn't work with this version :-(
  290.  
  291. RAWPATCH / MFM
  292. --------------
  293. Two utilities to experiment with raw disk data. So obscure as to be
  294. almost unusable. Use rawpatch to read in raw track data, then mfm to
  295. decode it.
  296. Hint: ALWAYS use -I -W with rawpatch (index sync & word sync). At the
  297. very least mfm likes its input wordsync'ed, and you can only get an
  298. idea of the sector skewing if you read starting from the index pulse.
  299. Hint: use -v on mfm to get a verbose output (or even -vv ).
  300.  
  301. GEOMETRY
  302. --------
  303. This program sends a TD_GETGEOMETRY command to any device to find out
  304. the media layout AND with fd.device it gets some hidden extra
  305. information about the interleave, skew factors etc.
  306.  
  307. CRC
  308. ---
  309. Just a simple program to generate CRC's for files, but I've added an
  310. option to generate a CRC for each block (by using eg -b512), which by
  311. default is the one used on disk sectors (pc MFM that is, not amiga style).
  312.  
  313.  
  314. Frank Swift and Simon N Goodwin, Manchester and Oldbury, UK, August 1997.
  315.